Inside Macintosh: /

QuickDraw 3D RAVE / QuickDraw 3D RAVE Reference

QuickDraw 3D RAVE Routines / Public Draw Context Methods

TQADrawTriMeshTexture

A drawing engine may define a method to draw a texture-mapped triangle mesh. This method is optional and must be supported only by drawing engines that support texture mapping.

typedef void (*TQADrawTriMeshTexture) (
                                       const TQADrawContext *drawContext,
                                       unsigned long nTriangles,
                                       const TQAIndexedTriangle *triangles);

drawContext

A draw context.

nTriangle

The number of indexed triangles pointed to by the triangles parameter.

triangles

A pointer to an array of indexed triangles. See "Indexed Triangle Structure" (page 1-80) for a description of indexed triangles.

DESCRIPTION

Your TQADrawTriMeshTexture function should draw the texture-mapped triangle mesh specified by the triangles parameter into the draw context specified by the drawContext parameter. Each triangle in the mesh is defined by a TQAIndexedTriangle data structure, which contains three indices into the array of texture vertices previously submitted to the draw context by a call to the QASubmitVerticesTexture function.

SPECIAL CONSIDERATIONS

The TQADrawTriMeshTexture method is optional. If your drawing engine does not support triangle meshes, QuickDraw 3D RAVE decomposes a triangle mesh into individual triangles when the user calls the QASubmitVerticesTexture function to submit a triangle mesh.